Settings Values for Standard Controls
This section lists the initial, minimum, and maximum settings for all standard controls. You can use these values in the control resource when creating a new control from a resource or with the function NewControl
. Note that some controls specify other information besides their range in their minimum and maximum settings. For example, bevel buttons use the high byte of their minimum value to indicate their behavior.
Control Values
-
Push button (pre-Appearance)
-
Initial:
0
Minimum:
0
Maximum:
1
-
Push button (Appearance-compliant)
-
Initial:
0
Minimum:
0
Maximum:
1
-
Checkbox (pre-Appearance)
-
Initial:
kControlCheckboxUncheckedValue
Minimum:
kControlCheckboxUncheckedValue
Maximum:
kControlCheckboxCheckedValue
-
Checkbox (Appearance-compliant)
-
Initial:
kControlCheckboxUncheckedValue
Minimum:
kControlCheckboxUncheckedValue
Maximum:
kControlCheckboxCheckedValue
or kControlCheckboxMixedValue
-
Radio button (pre-Appearance)
-
Initial:
kControlRadioButtonUncheckedValue
Minimum:
kControlRadioButtonUncheckedValue
Maximum:
kControlRadioButtonCheckedValue
-
Radio button (Appearance-compliant)
-
Initial:
kControlRadioButtonUncheckedValue
Minimum:
kControlRadioButtonUncheckedValue
Maximum:
kControlRadioButtonCheckedValue
or kControlRadioButtonMixedValue
-
Scroll bar (pre-Appearance and Appearance-compliant versions)
-
Initial:
Appropriate value between -32768 and 32768.
Minimum:
-32768 to 32768
Maximum:
-32768 to 32768; when the maximum setting is equal to the minimum setting, the scroll bar is inactive.
-
Bevel button
-
Initial:
If you wish to attach a resource-based menu, the menu's resource ID. If you wish to attach a non-resource-based menu, you must pass in a non-zero initial value, then call the
SetControlData
function with the kControlBevelButtonMenuHandleTag
control data tag constant and the return value from a call to the NewMenu
function. If no menu is to be attached, 0.
Minimum:
High byte specifies behavior; see Bevel Button Behavior Constants
and Bevel Button Menu Constants
. Low byte specifies content type; see Bevel Button and Image Well Content Type Constants
.
Maximum:
Resource ID of bevel button's content if resource-based; see Bevel Button and Image Well Content Type Constants
.
-
Slider
-
Initial:
Appropriate value between -32768 and 32768; for tick mark variant, the number of ticks. The control definition function resets this value to the minimum setting once the slider is created.
Minimum:
-32768 to 32768
Maximum:
-32768 to 32768; when the maximum setting is equal to the minimum setting, the slider is inactive.
-
Disclosure triangle
-
Initial:
0 (collapsed) or 1 (expanded)
Minimum:
0 (collapsed)
Maximum:
1 (expanded)
-
Progress indicator
-
Initial:
Appropriate value between -32768 and 32768.
Minimum:
-32768 to 32768
Maximum:
-32768 to 32768
-
Little arrows
-
Initial:
Appropriate value between -32768 and 32768.
Minimum:
-32768 to 32768
Maximum:
-32768 to 32768
-
Asynchronous arrows
-
Initial:
Reserved. Set to 0.
Minimum:
Reserved. Set to 0.
Maximum:
Reserved. Set to 0.
-
Tab control
-
Initial:
Resource ID of the
'tab#'
resource you are using to hold tab information. The control definition function resets this value to the minimum setting once the tab control is created. Under Appearance 1.0.1 and later, a value of 0 indicates not to read a 'tab#'
resource; see ControlTabInfoRec
.
Minimum:
Ignored. The control definition function resets this value to 1 once the tab control is created.
Maximum:
Under Appearance 1.0, the maximum value is ignored. Under Appearance 1.0.1, the maximum value specifies the number of tabs in the tab control.
-
Separator line
-
Initial:
Reserved. Set to 0.
Minimum:
Reserved. Set to 0.
Maximum:
Reserved. Set to 0.
-
Primary group box and
secondary group box
-
Initial:
Ignored if group box has text title. If the group box has a checkbox or pop-up button title, same value as the checkbox or pop-up button.
Minimum:
Ignored if group box has text title. If the group box has a checkbox or pop-up button title, same minimum setting as the checkbox or pop-up button.
Maximum:
Ignored if group box has text title. If the group box has a checkbox or pop-up button title, same maximum setting as the checkbox or pop-up button.
-
Image well
-
Initial:
Resource ID of the image well's content, if the content type specified in the minimum value is resource-based. The control definition function resets this value to 0 once the image well is created.
Minimum:
Low byte specifies content type; see Bevel Button and Image Well Content Type Constants
. The control definition function resets this value to 0 once the image well is created.
Maximum:
Ignored. The control definition function resets this value to 2 once the image well is created.
-
Pop-up arrow
-
Initial:
Reserved. Set to 0.
Minimum:
Reserved. Set to 0.
Maximum:
Reserved. Set to 0.
-
Placard
-
Initial:
Reserved. Set to 0.
Minimum:
Reserved. Set to 0.
Maximum:
Reserved. Set to 0.
-
Clock
-
Initial:
One or more of the clock value flags; see Clock Value Flag Constants
. The control definition function resets this value to 0 once the clock is created.
Minimum:
Reserved. Set to 0.
Maximum:
Reserved. Set to 0.
-
User pane
-
Initial:
One or more of the control feature constants; see Specifying Which Appearance-Compliant Messages Are Supported
. The control definition function resets this value to 0 once the user pane is created.
Minimum:
Ignored. The control definition function resets this value to a setting between -32768 to 32768 once the user pane is created.
Maximum:
Ignored. The control definition function resets this value to a setting between -32768 to 32768 once the user pane is created.
-
Editable text field
-
Initial:
Reserved. Set to 0.
Minimum:
Reserved. Set to 0.
Maximum:
Reserved. Set to 0.
-
Static text field
-
Initial:
Reserved. Set to 0.
Minimum:
Reserved. Set to 0.
Maximum:
Reserved. Set to 0.
-
Picture
-
Initial:
Resource ID of the
'pict'
resource you wish to display. The control definition function resets this value to 0 once the picture control is created.
Minimum:
Reserved. Set to 0.
Maximum:
Reserved. Set to 0.
-
Icon
-
Initial:
Resource ID of the
'cicn'
, 'ICON'
, or icon suite resource you wish to display. For icon suite variant, it only looks for an icon suite. If not, it looks for a 'cicn'
or 'ICON'
resource. The control definition function resets this value to 0 once the icon control is created.
Minimum:
Reserved. Set to 0.
Maximum:
Reserved. Set to 0.
-
Window header
-
Initial:
Reserved. Set to 0.
Minimum:
Reserved. Set to 0.
Maximum:
Reserved. Set to 0.
-
List box
-
Initial:
Resource ID of the
'ldes'
resource you are using to hold list box information. The control definition function resets this value to 0 once the list box is created. An initial value of 0 indicates not to read an 'ldes'
resource under Appearance 1.0.1 and later.
Minimum:
Reserved. Set to 0.
Maximum:
Reserved. Set to 0.
-
Pop-up menu (pre-Appearance and Appearance-compliant versions)
-
Initial:
One or more of the pop-up menu title constants.
Minimum:
Resource ID of the 'MENU'
resource.
Maximum:
Width (in pixels) of the pop-up menu title.
-
Radio group
-
Initial:
Set to 0 on creation. The control definition function resets this value to the index of the currently selected embedded radio button control once the radio group is created. If currently selected control does not support radio behavior, value will be set to 0 and the control will be deselected. To deselect all controls, set to 0.
Minimum:
Set to 0.
Maximum:
Set to 0 on creation. The control definition function resets this value to the number of embedded controls as controls are added.
© 1998 Apple Computer, Inc. – (Last Updated 19 Nov 98)
Mac OS 8 and 9 Developer Documentation
> Human Interface Toolbox
> Control Manager
>
